home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 05.zip / BS1 part 5 / Spirea-X.adf / BootX5.10 / BootX.doc < prev    next >
Text File  |  1992-08-27  |  89KB  |  2,946 lines
  1.  
  2.  
  3.                          BootX v5.10 User's Manual                   1
  4.  
  5.  
  6.                                 BootX v5.10
  7.  
  8.                Copyright © 1989, 1990, 1991, 1992 Peter Stuer
  9.                             All rights reserved
  10.  
  11.                         Release date August 27, 1992
  12.  
  13.                                  FREEWARE
  14.  
  15.                                 User Manual
  16.  
  17.                    Member of SHI Safe Hex International
  18.  
  19.  
  20.      COPYRIGHT NOTICE 
  21.  
  22.        BootX software and documentation are © 1989, 1990, 1991, 1992
  23.      by Peter Stuer. All rights reserved.  
  24.  
  25.  
  26.      DISCLAIMER 
  27.  
  28.        BootX has been thoroughly tested and is the result of a
  29.      constant process of changes and updates that started in April
  30.      1989.  The program has proven to be stable in everyday use.  The
  31.      author is not responsible for any loss of data, damages to
  32.      software or hardware that may result directly or indirectly from
  33.      the use of this program.  The author reserves the right to make
  34.      changes to the software or documentation without notice.  
  35.  
  36.  
  37.      PREFACE 
  38.  
  39.        This program is freeware, this means that you can copy it
  40.      freely as long as you don't ask any more money for it than a
  41.      nominal fee for copying.  If you want to distribute this program
  42.      you should keep this document with it.  This program cannot be
  43.      used for commercial purposes without written permission from the
  44.      author.  
  45.  
  46.        Special permission is hereby granted to include BootX in
  47.      Public-Domain collections such as Fred Fish's Amiga Library.  
  48.  
  49.  
  50.      A MESSAGE FROM OUR SPONSORS...  
  51.  
  52.        Our motto: "Safe Hex..." 
  53.  
  54.        BootX can be kept up to date thanks to the energy and work put
  55.      into a global anti-virus information bank called Safe Hex
  56.      International (SHI) founded by Erik Løvendahl Sørensen from
  57.      Denmark.  
  58.  
  59.        This group has over 250 international members now, among them
  60.      some of the programmers of well-known anti-virus programs like
  61.      Steve Tibbet and Jonathan Potter.  Among the activities of this
  62.  
  63.  
  64.      
  65.  
  66.  
  67.                          BootX v5.10 User's Manual                   2
  68.  
  69.  
  70.      group are: 
  71.  
  72.      - Spreading information to anti-virus programmers as fast as
  73.        possible.
  74.  
  75.      - Trying to get names and proof against virus programmers and
  76.        giving the information to the justice department of his/her
  77.        country to press charges.
  78.  
  79.      - Writing articles in over 8 popular magazines to inform new Amiga
  80.        users about viruses and how to protect themselves.
  81.  
  82.      - Collecting viruses and virus information as well as the programs
  83.        to kill the viruses.
  84.  
  85.      - Helping people to get their money back if it has been lost due
  86.        to virus infection.
  87.  
  88.      - Releasing the newest and best viruskillers found.
  89.  
  90.      - We have set up over 20 Regional Virus Centers worldwide.  These
  91.        virus centers provide free help against viruses through a
  92.        hotline and they translate the newest viruskillers and their
  93.        documentation in their local language.
  94.  
  95.        Also the organization is prepared to pay $ 1000 US for the
  96.      name and the address of a virus programmer.  All information
  97.      will be delt with confidentially and will be handed over to the
  98.      proper authorities of the virus programmer's country. Data
  99.      crimes are punished severely most of the time with up to 5 years
  100.      imprisonment.  
  101.  
  102.        All this is volunteer work.  If you want some more information
  103.      about this organization or you want to sponsor our work, send a
  104.      self-addressed envelope and 2 international mail response
  105.      coupons to the following address: 
  106.  
  107.              SHI Safe Hex International
  108.              Erik Løvendahl Sørensen
  109.              Snaphanevej 10
  110.              4720 Præstø
  111.              Denmark - Europe
  112.  
  113.              Phone: 00 45 53 79 25 12
  114.              Fax  : 00 45 53 79 34 98
  115.              Fidonet (soon)
  116.  
  117.  
  118.      PACKAGE 
  119.  
  120.      The BootX package consists of: 
  121.  
  122.              BootX                   The program file
  123.              BootX.BBLib             The BootX bootblock library
  124.              BootX.Brain             An example of a brainfile
  125.              BootX.Recog             Recognition information
  126.  
  127.  
  128.      
  129.  
  130.  
  131.                          BootX v5.10 User's Manual                   3
  132.  
  133.  
  134.              BootX.doc               This file
  135.              BootX.history           Complete history of BootX
  136.              BootX.alarm             An example of an alarm sample
  137.  
  138.  
  139.                                    NOTE
  140.  
  141.           The BootX.BBLib, BootX.Brain, BootX.Recog, BootX.alarm
  142.           or files are not required to run the program.  BootX
  143.           will display an error message if any of these files
  144.           are not found but will continue to run.  
  145.  
  146.           The BootX.Recog file is required if you want to do any
  147.           checking of files or bootblocks.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      
  193.  
  194.  
  195.                          BootX v5.10 User's Manual                   4
  196.  
  197.  
  198.      Chapter 1 Introducing BootX    
  199.  
  200.        BootX is a powerful viruskiller for the Commodore-Amiga computer.
  201.      It is fast (written completely in assembler) and tries to be as
  202.      user friendly as possible.
  203.  
  204.  
  205.      1.1 System requirements     
  206.  
  207.        BootX should run on any Amiga system with at least 512K RAM and
  208.      one disk-drive.  BootX requires KickStart v2.04 or higher to run.
  209.      Special care has been taken in the program design to make the
  210.      program work with 68020, 68030 and 68040 processors without
  211.      sacrificing 68000 compatibility.
  212.  
  213.        Should you have any trouble running BootX on your machine, please
  214.      write to me with the full specifications of your machine, that is
  215.      KickStart version, model, expansion boards etc...
  216.  
  217.        BootX also requires the ReqTools.library v38 or higher.  ReqTools
  218.      is copyright 1992 by Nico François.
  219.  
  220.        If you want to save and load files that have been crunched with
  221.      PowerPacker you will also need the PowerPacker.library v35 or
  222.      higher.  PowerPacker is copyright 1992 by Nico François.
  223.  
  224.        To decrunch Library Imploded files during a file check you'll need
  225.      the Explode.library v6.0 or higher.
  226.  
  227.  
  228.      1.2 About the author and the program 
  229.  
  230.        Since so many people keep asking me about it...  I graduated in
  231.      June 1991 as a programmer-analyst.  BootX was created because at
  232.      the time (April 1989) I did not trust the available viruskillers.
  233.      In those days only the SCA and the Byte Bandit bootviruses where a
  234.      threat to our bootblocks.
  235.  
  236.        If you have suggestions or remarks about this program, or if you
  237.      find any bugs, please let me know.  If you find any new viruses or
  238.      linkviruses that BootX does not recognize yet, please send them on
  239.      a disk to me (my address follows this paragraph).  I will return
  240.      the disk to you with an updated copy of BootX.
  241.  
  242.        When sending in bug reports, please state exactly under what
  243.      circumstances the bug occurred, what equipment was used and what
  244.      happened.  If possible also try to give me enough information to
  245.      reproduce the bug.  It is very difficult to find bugs when you
  246.      don't know exactly what happened.
  247.  
  248.      Write to the following address:
  249.  
  250.              Peter Stuer
  251.              Kauwlei 21
  252.              B-2550 Kontich
  253.              Belgium - Europe
  254.  
  255.  
  256.      
  257.  
  258.  
  259.                          BootX v5.10 User's Manual                   5
  260.  
  261.  
  262.  
  263.              Fido: 2:292/603.7
  264.  
  265.  
  266.      1.3 Gettings updates      
  267.  
  268.        If you send me a 3½" disk and a letter to get the most recent
  269.      version of BootX, please don't forget to include enough stamps
  270.      or money to send your disk back.  BootX has been generating a
  271.      lot of mail and most of the times I had to pay the postal fee
  272.      myself to send the disk back.  Remember, BootX itself is a
  273.      FREEWARE so no money is expected for it (although I won't refuse
  274.      it, grin...).  Every letter with a disk AND money will be
  275.      answered AS SOON AS POSSIBLE...  
  276.  
  277.        And please, state your name and address clearly in print
  278.      because sometimes they are nearly impossible to decipher.  
  279.  
  280.        I will also try to put the latest available version of BootX
  281.      on the following BBS (this may change without further notice): 
  282.  
  283.              Great Balls Of Fire BBS 
  284.              Herman Stevens 
  285.              Lubbeek 
  286.              ADS Regional Coordinator Belgium 
  287.              Tel. +32-(0)16-64.09.12 
  288.              2400 BPS N.8.1 
  289.              24-24 h.  
  290.              Fido Node 2:292/603 
  291.  
  292.  
  293.      1.4 Before you complain...     
  294.  
  295.        I just want to mention a couple of things here that will only
  296.      show up if you're snooping around in the system when BootX is
  297.      running.  
  298.  
  299.        Some of you seem to be running the Commodore development tool
  300.      Enforcer all the time.  I have gotten some letters about the
  301.      Enforcer hits BootX causes.  The only way I can check your
  302.      memory and vectors is to do some low memory reads.  These will
  303.      typically show up as an Enforcer READ hit to addresses in the
  304.      region  to .  This is normal.  You can expect this to happen at
  305.      various points during program execution and particularly during
  306.      a vector check.  Enforcer WRITE hits are not normal.  Please
  307.      report these ! 
  308.  
  309.  
  310.                                    NOTE
  311.  
  312.           If you haven't the faintest idea what I am talking
  313.           about, don't worry. I should only concern those people
  314.           who know what Enforcer does and how to use it.  
  315.  
  316.  
  317.        BootX also launches a task called 'SnoopDos'.  This is done to
  318.  
  319.  
  320.      
  321.  
  322.  
  323.                          BootX v5.10 User's Manual                   6
  324.  
  325.  
  326.      prevent some old PowerPacker trojan horse to install itself in
  327.      memory.  This task uses no CPU time.  It is removed when BootX
  328.      quits running.  Also, this task will only be launched when there
  329.      isn't yet a task called 'SnoopDos' in the system.  This ghost task
  330.      won't prevent the real SnoopDos (by Eddy Carroll, Freely
  331.      distributable) from being run or functioning correct.
  332.  
  333.  
  334.      1.5 Acknowledgments      
  335.  
  336.      - Nico François - For his ReqTools and PowerPacker packages.  Also
  337.        for answering my questions on programming in the new KickStart
  338.        v2.04 environment and for ßeta testing BootX.
  339.  
  340.      - BootX ßeta testers - In no particular order:
  341.  
  342.              Nico François (Belgium)
  343.              Johan Van Houtven (Belgium)
  344.              Bart Beeckmans (Belgium)
  345.              Steffen Salzmann (BRD)
  346.              James Knittle (USA)
  347.              Erik Løvendahl Sørensen (Denmark)
  348.  
  349.      - 'Big A' (my A3000) for assembling BootX fast and safe.
  350.  
  351.        BootX has been created using the Macro68 Assembler, WShell 2.0 and
  352.      CygnusEd Professional on an Amiga A3000 25/100 with 6MB memory.
  353.      The BootX documentation was formatted with my Roff clone ARoff.
  354.  
  355.        The assembler source code occupies more than 742.400 bytes and
  356.      consists of more than 34500 lines.
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.      
  385.  
  386.  
  387.                          BootX v5.10 User's Manual                   7
  388.  
  389.  
  390.      Chapter 2 Getting Started    
  391.  
  392.        This chapter will explain how to install a complete working
  393.      environment. You should make a copy of the BootX package before
  394.      starting to make changes. If you are not familiar with copying a
  395.      disk, see Commodore's Introduction to Amiga for instructions.
  396.  
  397.  
  398.      2.1 Installing BootX on hard disk  
  399.  
  400.        An install script has been provided to install BootX on your
  401.      hard disk.  It finds out which configuration you are using and acts
  402.      accordingly.  Simply follow the instructions.
  403.  
  404.        If you insist on doing things manually, here's what you should do:
  405.  
  406.      - Copy the ReqTools.library into the Libs: directory.
  407.  
  408.      - Copy the BootX files in a directory of your choice.
  409.  
  410.  
  411.  
  412.                                    NOTE
  413.  
  414.           Although the files BootX.BBLib, BootX.Brain,
  415.           BootX.Recog or BootX.Alarm are not required to run the
  416.           program, there really isn't much you can do if you do
  417.           not install them.  
  418.  
  419.  
  420.        If you want to install different bootblocks than the standard
  421.      AmigaDOS Install bootblocks, BootX needs the BootX.BBLib file.
  422.  
  423.        If you want to check for viruses of any kind, the BootX.Recog file
  424.      is needed which contains the identification patterns BootX uses.
  425.  
  426.        The BootX.Brain file is simply included as an example.  It is
  427.      advisable you create your own brainfile, should you encounter a
  428.      bootblock that BootX does not yet recognize.  If the bootblock is
  429.      added to the Recog file later, BootX will use that information.
  430.  
  431.        When BootX finds a file called 'BootX.alarm' in the directory from
  432.      which it started, and this file is a FORM 8SVX sound sample, BootX
  433.      will play this sample every time an unknown bootblock or a boot-,
  434.      file or linkvirus is detected.  The FORM 8SVX file format is the
  435.      standard Amiga file format for audio samples.  All the major sound
  436.      digitizers or editing programs use this file format.  BootX will
  437.      use the settings it finds in the file to play the sample.
  438.  
  439.        It is very important that you also copy the BootX icon. As of
  440.      version 5.00 all the user preferences are kept in the icon. You
  441.      may ofcourse provide an icon of yourself.
  442.  
  443.  
  444.      2.2 Starting BootX     
  445.  
  446.  
  447.  
  448.      
  449.  
  450.  
  451.                          BootX v5.10 User's Manual                   8
  452.  
  453.  
  454.        BootX v5.10 (from here on referred to as BootX) was written to be
  455.      used by both beginners and experienced users.  BootX can be
  456.      started both from CLI and the Workbench.
  457.  
  458.  
  459.      2.2.1 Starting BootX from the CLI  
  460.  
  461.      To start BootX from the CLI simply type:
  462.  
  463.              1> BootX
  464.  
  465.      followed by a return.  This loads the BootX program and starts
  466.      it.
  467.  
  468.  
  469.                                    NOTE
  470.  
  471.           If you haven't saved your preferences yet, BootX
  472.           initially tries to load the BootX.BBLib, BootX.Brain,
  473.           and BootX.Recog files from the current directory.  If
  474.           your current directory is not the same as the one
  475.           BootX is in, change to it with the CLI command CD: 
  476.  
  477.                   1> cd <BootX directory> 
  478.  
  479.  
  480.  
  481.      2.2.1 Starting BootX from the Workbench  
  482.  
  483.        This is the easy part.  Simply click on the accompanying icon and
  484.      BootX starts.
  485.  
  486.        You can also use the Execute Command item from the Workbench menu
  487.      to run BootX.
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.      
  513.  
  514.  
  515.                          BootX v5.10 User's Manual                   9
  516.  
  517.  
  518.      Chapter 3 The BootX screen   
  519.  
  520.        A lot of viruscheckers and viruskillers have already written for
  521.      the Amiga but none of them offered all the features I needed.
  522.      Since the first virus, the SCA bootvirus, a lot of things have
  523.      changed in the Amiga scene.  File and linkviruses terrorize our
  524.      hard disks.  Virus can spread as part of a crunched executable.
  525.      Enters BootX.
  526.  
  527.        BootX can check the bootblock of a disk, check memory for any
  528.      resident viruses and scan a disk for link and fileviruses.  It can
  529.      load bootblock libraries with bootblocks for you to write on your
  530.      disks as an alternative for the boring AmigaDOS Install bootblock.
  531.      It can load "brain files" so you can add any new bootblocks that
  532.      BootX does not recognize yet.
  533.  
  534.        Let's start a guided tour of the screen.  The main screen offers
  535.      several gadgets and menus.  Just click the appropriate gadget or
  536.      select a menu item to perform an action.
  537.  
  538.  
  539.                                    NOTE
  540.  
  541.           The BootX screen can be popped to the front at any
  542.           time by pressing the hot key combination which
  543.           defaults to control left-alt B.  
  544.  
  545.  
  546.  
  547.      3.1 Quit      
  548.  
  549.        When you click on the first gadget on the left side of the screen,
  550.      BootX quits running.
  551.  
  552.        Before BootX quits it will check to see if you have made any
  553.      changes to the BBLib file or to the Brain file.  If so, it will
  554.      ask you first if you want to save the changes you have made.
  555.  
  556.  
  557.                                    NOTE
  558.  
  559.           Watch out that you don't leave any infected disks in
  560.           your drives when you quit BootX !  Especially disks
  561.           that are infected with disk-validator viruses.  
  562.  
  563.  
  564.  
  565.      3.2 Read Bootblock     
  566.  
  567.        This gadget explicitly instructs BootX to read the bootblock from
  568.      the current selected drive into the buffer.  Normally BootX
  569.      detects when a new disk is inserted and automatically reads its
  570.      bootblock.  But some old 5¼ drives don't support this automatic
  571.      diskchange.  This gadget can also be used to read the bootblock
  572.      after another program has modified the bootblock.
  573.  
  574.  
  575.  
  576.      
  577.  
  578.  
  579.                          BootX v5.10 User's Manual                  10
  580.  
  581.  
  582.        You will also need to use this gadget when you have turned of the
  583.      auto-diskchange detection or when you have locked a drive (see
  584.      further).
  585.  
  586.        When BootX detects a virus in the bootblock it just read, a requester
  587.      will be brought up asking you if you would like to kill the virus.
  588.      If you answer positively by clicking on the Yes gadget, BootX will
  589.      try to install the bootblock current selected from the Bootblock
  590.      library.
  591.  
  592.      3.3 Write Bootblock     
  593.  
  594.        Here you instruct BootX to write the bootblock currently in the
  595.      buffer to the selected drive.  BootX maintains a buffer that holds
  596.      the last read bootblock.  This buffer is also visible in the large
  597.      display window in semi-ASCII form (more about this later).  The
  598.      buffer allows you to read a bootblock from one disk and then copy
  599.      it to another.
  600.  
  601.  
  602.      3.4 The drives cycle gadget   
  603.  
  604.        You can connect up to 4 disk drives to the Amiga.  BootX checks
  605.      how many drives are connected to the Amiga and installs their
  606.      device names in the list of this cycle gadget.
  607.  
  608.        Only the drives that are connected to the Amiga and are turned on
  609.      (in case of external drives) will be reported by this gadget.  To
  610.      select a particular drive keep clicking on the gadget until its
  611.      device name is shown.
  612.  
  613.  
  614.      3.5 Lock Drive     
  615.  
  616.        Normally when you insert a disk in the disk-drive, the Amiga tries
  617.      to see if the checksum of the disk is OK.  When it is not, the
  618.      Amiga tries to validate it.  Pre-2.0 KickStarts needed to load and
  619.      execute a program called Disk-Validator from the L directory to
  620.      check and/or repair the checksum.
  621.  
  622.        When a disk-drive is 'locked', BootX will prevent AmigaDOS from
  623.      validating your disk.  This also means that Disk-Validator viruses
  624.      have no chance of getting in.  You can insert and remove disks as
  625.      many times as you like.
  626.  
  627.        Also the automatic diskchange detect will be temporarily disabled.
  628.  
  629.  
  630.      3.6 Check files     
  631.  
  632.        This gadget is a short-cut for the Check Files menu item. See
  633.      later.
  634.  
  635.  
  636.      3.7 Show installable bootblocks    
  637.  
  638.  
  639.  
  640.      
  641.  
  642.  
  643.                          BootX v5.10 User's Manual                  11
  644.  
  645.  
  646.        When you click on this gadget, BootX will display the contents of
  647.      the current loaded bootblock library.  You simply click on the
  648.      name of the bootblock to select it as current bootblock.  Either
  649.      double-click on the name or click and select OK.
  650.  
  651.        This action only selects the bootblock !  It is not immediately
  652.      written to the current disk nor is it put in the bootblock buffer.
  653.      You can see the name of the current selected bootblock in the
  654.      small window next to the gadget.
  655.  
  656.        If you do not want to make a change select the Cancel gadget of
  657.      the requester.
  658.  
  659.  
  660.                                    NOTE
  661.  
  662.           BootX already knows 2 bootblocks even when no
  663.           bootblock library has been loaded.  They are the
  664.           standard AmigaDOS 2.0 bootblocks for Old and New
  665.           Filesystem disks.  Their names have a little dot
  666.           completely to the right.  
  667.  
  668.  
  669.  
  670.      3.8 Built-in bootblock name    
  671.  
  672.        This window shows the name of the selected bootblock.
  673.  
  674.  
  675.      3.9 Install      
  676.  
  677.        Here you can write the selected bootblock to the bootsectors of
  678.      the disk in the current drive.
  679.  
  680.        At startup BootX looks for a file called "BootX.BBLib" in the
  681.      directory from which BootX started.  It contains several
  682.      alternative bootblocks.  It is possible to load another bootblock
  683.      library using the "Load" menu item of the "BBLib" menu (see
  684.      further).
  685.  
  686.  
  687.      3.10 Message window     
  688.  
  689.        This window reports messages and errors resulting from the various
  690.      operations.
  691.  
  692.  
  693.      3.11 Main display window    
  694.  
  695.        Shows the bootblock that is currently in the buffer in semi-ASCII
  696.      representation.  Only the readable characters are shown.  This
  697.      allows you to check for readable text signifying the nature of the
  698.      bootblock when BootX reports "Unknown bootblock".
  699.  
  700.        The main display window is also used for the output of several
  701.      other BootX functions.
  702.  
  703.  
  704.      
  705.  
  706.  
  707.                          BootX v5.10 User's Manual                  12
  708.  
  709.  
  710.      Chapter 4 The Project Menu   
  711.  
  712.      4.1 Load Recog file    
  713.  
  714.        As of BootX v4.30 all the recognition information BootX needs to
  715.      identify a virus or a bootblock is contained in a file called
  716.      BootX.Recog.  With this menu item you can load different
  717.      BootX.Recog files than the one BootX loads at started called
  718.      "BootX.Recog".
  719.  
  720.        BootX can remember the name of the Recog file and where it came
  721.      from.  After loading a Recog file from a different path or with a
  722.      different filename simply save your preferences.  When BootX
  723.      starts the next time it will try to load the Recog file with that
  724.      path and filename.
  725.  
  726.  
  727.                                    NOTE
  728.  
  729.           The BootX.Recog files are coded and protected by a
  730.           checksum to prevent anyone from modifying the
  731.           information it contains with a file editor.  
  732.  
  733.  
  734.        Always try to get the latest version of the BootX.Recog file to
  735.      get maximum protection.  You can find out the version of a
  736.      BootX.Recog file in several ways:
  737.  
  738.      1. After BootX has successfully loaded a Recog file it will display
  739.         the version and the release date of the file.
  740.  
  741.      2. The BootX version and the Recog file version are always shown
  742.         in the title bar of the screen.
  743.  
  744.      3. Select the About menu item. The text will show the version and
  745.         the release date of the Recog file and how many bootblocks,
  746.         bootviruses and fileviruses it knows.
  747.  
  748.  
  749.                                    NOTE
  750.  
  751.           These numbers may vary from the number reported by the
  752.           "Show known xxx" menu items.  The numbers reported
  753.           here are the number of recog blocks that BootX can use
  754.           to identify a virus.  The "Show known xxx" menu items
  755.           only report all the different names that BootX uses,
  756.           f.e.  BootX can recognize several different mutants of
  757.           the same virus but the name will only show up once in
  758.           the "Show known bootviruses" list.  
  759.  
  760.  
  761.      3. Use the Workbench v2.x version command:
  762.  
  763.              1> version BootX.Recog
  764.  
  765.  
  766.  
  767.  
  768.      
  769.  
  770.  
  771.                          BootX v5.10 User's Manual                  13
  772.  
  773.  
  774.      4.2 Show known      
  775.  
  776.        This submenu allows you to view the contents of the current
  777.      loaded Recog file.  Use the submenu items Bootblocks,
  778.      Bootviruses or Fileviruses to view the list you want.  BootX
  779.      will then pop up a list requester.  Use the scroll gadgets or
  780.      the scroll bar to move through the list.  The window title of
  781.      the requester will tell you how many entries are being shown.  
  782.  
  783.  
  784.                                    NOTE
  785.  
  786.           The selection 'Show known fileviruses' also shows the
  787.           linkviruses and trojan horses that BootX knows.  
  788.  
  789.  
  790.      Click on the window's close gadget to remove the requester.
  791.  
  792.  
  793.      4.3 Print known     
  794.  
  795.        Here you can request BootX to print the contents of the current
  796.      loaded Recog file to your printer.
  797.  
  798.  
  799.                                    NOTE
  800.  
  801.           If you have to wait a long time (about 10 seconds) and
  802.           nothing happens, please check that your printer is
  803.           turned on and if so that it is on-line.  BootX will
  804.           not be able to report an error until the default
  805.           time-out period is passed (usually 30 seconds) or
  806.           until the user put the printer on-line.  
  807.  
  808.  
  809.  
  810.      4.4 Iconify      
  811.  
  812.        Selecting Iconify causes BootX to close its screen and release as
  813.      much memory as possible.  BootX will then try to find its icon in
  814.      the drawer from which it started and use it to create an AppIcon
  815.      on the WorkBench.  For more information about AppIcons I refer to
  816.      the Amiga User Interface Style Guide.
  817.  
  818.        There are two ways to wake up BootX. You press the BootX hot key
  819.      combination (default Ctrl Left-Alt B) or you wake BootX up via its
  820.      AppIcon. The hot key combination can be changed via the menu item
  821.      Preferences/Edit (see later).
  822.  
  823.        When iconified BootX waits for two kinds of events.  If you
  824.      double-click on the icon BootX reopens its screen and returns to
  825.      the state as it was before you iconified it with all the
  826.      information and preferences intact.
  827.  
  828.        Another way to wake up BootX is to select or shift-select one or
  829.      more disk or drawer icons and drop them on the BootX AppIcon.
  830.  
  831.  
  832.      
  833.  
  834.  
  835.                          BootX v5.10 User's Manual                  14
  836.  
  837.  
  838.      BootX will then wake up and present its Check Files Preference
  839.      requester (see later).  Set your preferences and when you click on
  840.      the Check Files gadget BootX will present you with the path
  841.      requester.  BootX will have inserted the Volume name or the drawer
  842.      name in the string gadget.  You only have to click on OK or press
  843.      return to start the file check with that path.
  844.  
  845.        If you drop a file icon on the AppIcon BootX will use that path of
  846.      that file as its starting point for the file check.  This way you
  847.      can drop the icons you have 'left out' using the Leave Out
  848.      menu item of the Workbench Icon menu on the BootX AppIcon.
  849.  
  850.        At present BootX uses no CPU time at all when it is in its
  851.      iconified state.  No checking of memory or of newly inserted disks
  852.      is done.  There is no need to continuously keep checking every
  853.      disk that is inserted.  Just check them once to make sure they are
  854.      virus-free.
  855.  
  856.  
  857.                                    NOTE
  858.  
  859.           If BootX can't find its icon it will use the default
  860.           tool icon instead. You can create your own default
  861.           tool icon using the Workbench 2.0 Icon Editor and save
  862.           it using the 'Save As Default Icon' menu item.  
  863.  
  864.           AppIcons are always positioned dynamically on the
  865.           Workbench screen, that is, whereever there is room.
  866.           You can not snapshot an AppIcon in a fixed place.  
  867.  
  868.  
  869.  
  870.      4.5 Help      
  871.  
  872.        Not yet implemented.
  873.  
  874.  
  875.      4.6 About      
  876.  
  877.        Here you can find out some details about BootX, among them the
  878.      version number, the Recog file version, and my address.  Always
  879.      try to get the latest version available to have optimum virus
  880.      protection.
  881.  
  882.  
  883.      4.7 Quit      
  884.  
  885.        Guess what this one does...
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.      
  897.  
  898.  
  899.                          BootX v5.10 User's Manual                  15
  900.  
  901.  
  902.      Chapter 5 The Check Menu   
  903.  
  904.        The Check menu concentrates all the possible checks that BootX has
  905.      to offer.
  906.  
  907.  
  908.      5.1 Check blocks     
  909.  
  910.        Some of the current viruses and possibly some to come alter or
  911.      damage the blocks on the surface of your disks.  When you ask
  912.      BootX to check the blocks of the current drive it will scan the
  913.      complete surface of the disk that is currently in the drive,
  914.      looking for damaged or infected blocks.
  915.  
  916.        When BootX encounters an infected block it will tell you together
  917.      with the name of the virus that infected that block.  Most of the
  918.      time the information that was in an infected block is lost but in
  919.      some cases the block can be repaired and the information restored.
  920.  
  921.        Currently BootX can repair blocks that are infected by the Saddam
  922.      disk-validator virus and by the Curse Of Little Sven virus.
  923.  
  924.        It will tell you when it finds blocks infected by the Lamer
  925.      Exterminator virus.
  926.  
  927.        To use the block check simply select the menu item. Make sure
  928.      there is no disk in the current drive. BootX will then lock the
  929.      drive and ask you to insert the disk you wish to check.
  930.  
  931.        During the scan you'll get a progress report. You can leave your
  932.      disk write-protected. BootX will then issue a warning and it will
  933.      scan the disk without making any modifications.
  934.  
  935.  
  936.                                    NOTE
  937.  
  938.           Be sure you insert your disk only after BootX asks for
  939.           it. This is necessary security and to make sure BootX
  940.           has a chance to recognize if your disk is a 880K or
  941.           1760K high-density disk.  
  942.  
  943.  
  944.  
  945.      5.2 Check memory     
  946.  
  947.        BootX checks the memory at strategic times during its actions.
  948.      With this memory action you can force BootX to recheck the memory.
  949.  
  950.        When it finds a virus you will be alert with an Amiga DisplayAlert
  951.      and BootX will try to kill the virus in memory.
  952.  
  953.        It is possible that the Amiga crashes after BootX has found a
  954.      virus.  BootX will try to restore any changed information but
  955.      sometimes this is not possible.  Therefore the safest solution has
  956.      been chosen of completely clearing the virus memory.
  957.  
  958.  
  959.  
  960.      
  961.  
  962.  
  963.                          BootX v5.10 User's Manual                  16
  964.  
  965.  
  966.  
  967.      5.2 Check vectors     
  968.  
  969.        The flexibility of the Amiga operating system lies in the fact the
  970.      programmers have so many options of altering the way the Amiga
  971.      does specific things.
  972.  
  973.        Regrettably virus programmers also know this and use various
  974.      'vectors', as the entry points are called, to add the virus code
  975.      to the operating system. BootX can identify and kill virus if it
  976.      knows it. But new viruses are being programmed every day.
  977.  
  978.        The vector check scans all the places in the Amiga memory that are
  979.      the most likely candidates for virus attacks.  During this scan it
  980.      generate a vector check report.  In this report is a lot of
  981.      technical information.  After the scan BootX displays the report
  982.      in the main window.  You can skip through the pages using the left
  983.      mouse button.  The right mouse button aborts at any time.  At the
  984.      end of the report BootX shows some information about your system.
  985.      If you need more accurate information use one of the many
  986.      dedicated tools.
  987.  
  988.        When BootX finds a vector which points to abnormal address it will
  989.      try to identify the program that changed that vector.  A lot of
  990.      programs 'patch' the operating system to fix bugs or to add
  991.      features.  Commodore itself fixes small bugs this way using the
  992.      SetPatch command.  I will try to keep BootX's knowledge base as up
  993.      to date as possible.
  994.  
  995.        A normal vector will be displayed in black with the message 'OK'
  996.      next to it or the name of the program that changed that vector.
  997.      If BootX can not decide what code uses the vector it will display
  998.      the message 'Please check' in white next to the vector. This does
  999.      not necessarily mean that the vector is used by a virus. Don't
  1000.      panic and contact a more experienced Amiga user (preferably a
  1001.      programmer).
  1002.  
  1003.        In case of doubt, save all your data and cold start the Amiga,
  1004.      that is, turn of the power and wait a few seconds before turning
  1005.      it on again.
  1006.  
  1007.  
  1008.      5.4 Reset vectors     
  1009.  
  1010.        Here you are given to option to clear the first five vectors that
  1011.      BootX shows in its vector check report.  These vectors are used to
  1012.      have foreign code survive a software reset (using the Ctrl - Left
  1013.      Amiga - Right Amiga key combination).
  1014.  
  1015.        This is not a fail safe way to kill a virus.  Also if any other
  1016.      software is using these vectors, it will not survive the next
  1017.      reset.  Also, some virus defend themselves against such action and
  1018.      will not allow BootX to reset those vectors.
  1019.  
  1020.  
  1021.      5.5 Check files     
  1022.  
  1023.  
  1024.      
  1025.  
  1026.  
  1027.                          BootX v5.10 User's Manual                  17
  1028.  
  1029.  
  1030.  
  1031.        BootX was written in the days that bootviruses were the greatest
  1032.      if not only treat to the Amiga, hence the name BootX.  Over the
  1033.      years this has changed.  The biggest danger now comes from file
  1034.      and linkviruses.  This menu option provides you with the most
  1035.      powerful tool in the Amiga world to fight and kill those viruses.
  1036.  
  1037.        After you select the Check files menu item or click on the Check
  1038.      files gadget BootX will present you with a Check Files Preferences
  1039.      requester. BootX gives you a lot of options to customize your file
  1040.      checks.
  1041.  
  1042.        To remove the requester without checking your files click on the
  1043.      window close gadget or the Cancel gadget.
  1044.  
  1045.  
  1046.      5.5.1 Virus handling     
  1047.  
  1048.        In the top left corner you will find a cycle gadget that gives
  1049.      the following options: Comment, Delete and Rename. It lets you
  1050.      decide what BootX should do when it encounters a file virus.
  1051.  
  1052.        The Comment option will let you add a filenote to the infected
  1053.      file telling you the name of the virus.  For example "BGS-9 (TTV1)
  1054.      filevirus (detected by BootX)" tells you that this file contains
  1055.      the BGS-9 filevirus and that it was detected by BootX.  You can
  1056.      see the filenote using most of the directory utilities of using
  1057.      the AmigaDOS 'List' command in the CLI or the Shell.
  1058.  
  1059.        The Delete option deletes the infected file.
  1060.  
  1061.        The Rename option renames the infected file to a name describing
  1062.      the virus. For example "002.BGS-9 virus" indicates that this file
  1063.      contains the BGS-9 virus and it was the 2nd virus found during
  1064.      this file check.
  1065.  
  1066.  
  1067.      5.5.2 Remove linkviruses     
  1068.  
  1069.        When this checkbox is checked, BootX will try to remove a
  1070.      linkvirus from an infected file. If the removal is successful the
  1071.      file can be used again without further danger.
  1072.  
  1073.        Be sure that enough memory is available during a file check as
  1074.      BootX needs to load the infected file completely into memory in
  1075.      order to repair it. Also there has to be enough disk spaces left.
  1076.  
  1077.        When the virus has been removed, you will find two files on your
  1078.      disk.  One contains the original infected file.  It will have a
  1079.      new name reflecting the kind of linkvirus that is attached to the
  1080.      file in the same way as the Rename option (see higher).  The file
  1081.      will not be executable anymore so there is no danger you
  1082.      accidentally infect your memory.  The virus code is still intact
  1083.      though so don't panic if another viruskiller reports there still
  1084.      is a virus on your disk.
  1085.  
  1086.  
  1087.  
  1088.      
  1089.  
  1090.  
  1091.                          BootX v5.10 User's Manual                  18
  1092.  
  1093.  
  1094.        The second file retains the original name and contains the cured
  1095.      program.
  1096.  
  1097.  
  1098.                                    NOTE
  1099.  
  1100.           Some of the older linkviruses and some of the new
  1101.           badly programmed linkviruses destroy the file in such
  1102.           a way that repair becomes impossible. BootX handles
  1103.           these cases gracefully and will tell you about it.  
  1104.  
  1105.  
  1106.  
  1107.      5.5.3 Handle viruses automatically    
  1108.  
  1109.        Normally BootX works completely interactively and asks the user's
  1110.      permission every step of the way. When you check this option BootX
  1111.      makes all decisions by itself and handles all viruses
  1112.      automatically. This is very handy when you want to check that
  1113.      400MB hard disk with 15000+ files on it.
  1114.  
  1115.  
  1116.      5.5.4 Show directories/files/check files    
  1117.  
  1118.        In the upper right hand corner you will find three options
  1119.      controlling the display during the file check.
  1120.  
  1121.        Check 'Show directories' if you want BootX to tell you when it
  1122.      enters a new directory.
  1123.  
  1124.        Check 'Show files' if you want BootX to show you the file it is
  1125.      currently checking. When this option is on BootX also tries to
  1126.      determine what kind of file it is looking at. Turn it off to
  1127.      reduce the time needed to check a path.
  1128.  
  1129.        Check 'Show checked files' if you want BootX to display only those
  1130.      files that it really is checking.
  1131.  
  1132.  
  1133.      5.5.5 Check crunched executables    
  1134.  
  1135.        BootX was the first viruskiller to offer you this powerful
  1136.      feature.  When it is checked BootX will try to decrunch all
  1137.      crunched executables in memory and then check the decrunched
  1138.      version of the file for any file- or linkviruses.
  1139.  
  1140.        Currently BootX can decrunch the following crunchers:
  1141.  
  1142.        all PowerPacker versions
  1143.        all Imploder versions
  1144.        TNM Cruncher 1.1
  1145.        MegaCruncher
  1146.  
  1147.        The Explode.library v6.0 or higher is required if you wish to
  1148.      decrunch Library Imploded files.
  1149.  
  1150.  
  1151.  
  1152.      
  1153.  
  1154.  
  1155.                          BootX v5.10 User's Manual                  19
  1156.  
  1157.  
  1158.        If there is a cruncher you would BootX like to be able to
  1159.      decrunch, then send me some files that have been crunched with it
  1160.      together with the name of the cruncher and preferably the cruncher
  1161.      program itself too. I will continue to add new decrunch code in
  1162.      future versions of BootX.
  1163.  
  1164.  
  1165.                                    NOTE
  1166.  
  1167.           If BootX detects a linkvirus in a crunched file,
  1168.           obviously it can not remove the virus since the file
  1169.           is crunched. BootX will tell you to decrunch the file
  1170.           first and ask you if you would like in the mean time
  1171.           to handle the virus like a file virus, that is, to
  1172.           comment, delete or rename the file (see higher).  
  1173.  
  1174.  
  1175.  
  1176.      5.5.6 Skip read-protected     
  1177.  
  1178.        Sometimes you want to protect certain files on your disks from
  1179.      reading by removing the read protection bit.
  1180.  
  1181.        When this option is selected, BootX will ignore all read protected
  1182.      files. This can be handy since BootX removes all protection bits
  1183.      from infected files except for the Archive and the Delete bit.
  1184.  
  1185.  
  1186.                                    NOTE
  1187.  
  1188.           This option is mutually exclusive with the
  1189.           'Auto-remove read-protection' option 
  1190.  
  1191.  
  1192.  
  1193.      5.5.7 Auto-remove read-protection     
  1194.  
  1195.        AmigaDOS 2.0 recognizes and honors the protection bits of a
  1196.      file.  That means that if the read protection is on, programs
  1197.      including the Workbench and the Shell are not allowed to read that
  1198.      file.  When BootX encounters such a file it will ask you if you
  1199.      want to remove the read protection of that file.
  1200.  
  1201.        If you answer Yes BootX preserves all other protection bits and
  1202.      removes the read protection. The file will then be rechecked.
  1203.  
  1204.        If you wish to restore the read protection afterwards, use the
  1205.      AmigaDOS command Protect like this:
  1206.  
  1207.              1> protect <filename> -r
  1208.  
  1209.      which will give the file its read protection back.
  1210.  
  1211.  
  1212.                                    NOTE
  1213.  
  1214.  
  1215.  
  1216.      
  1217.  
  1218.  
  1219.                          BootX v5.10 User's Manual                  20
  1220.  
  1221.  
  1222.           This option is mutually exclusive with the 'Skip read
  1223.           protected' option.  
  1224.  
  1225.  
  1226.  
  1227.      5.5.8 Generate report     
  1228.  
  1229.        Use this checkbox to turn on the BootX reporting feature. When
  1230.      checked BootX will generate a file check report containing all the
  1231.      information that was shown during the file check. Use this option
  1232.      when doing an unattended file check of large hard disks. The
  1233.      report will serve as a transcript of what happened during the file
  1234.      check.
  1235.  
  1236.  
  1237.      5.5.9 Silent check     
  1238.  
  1239.        When performing a file check in the background there is no need
  1240.      for BootX continuously displaying all the files it checks. This
  1241.      setting allows you to turn off this display while you can still
  1242.      have BootX make a file check report.
  1243.  
  1244.  
  1245.      5.5.10 Filter      
  1246.  
  1247.        To enable the path filter, check this checkbox gadget. See also
  1248.      section 6.1.
  1249.  
  1250.  
  1251.      5.5.11 Examine directories     
  1252.  
  1253.        This cycle gadget allows you to decide how BootX handles
  1254.      directories.
  1255.  
  1256.        'All' is the most general option and will have BootX enter all
  1257.      directories it encounters as many levels deep as required.
  1258.  
  1259.        'Interactively' will have BootX ask you permission to check a
  1260.      directory every time it encounters one. Check this option if you
  1261.      want to make a quick scan of the first level of a directory for
  1262.      example the root of a hard disk.
  1263.  
  1264.        'None' will cause BootX to skip any directory it finds.
  1265.  
  1266.  
  1267.      5.5.12 Checking files     
  1268.  
  1269.        You can start the file check by clicking on the 'OK' gadget. BootX
  1270.      will pop up a path requester. This is kind of a stripped down
  1271.      version of a file requester allowing you to comfortably navigate
  1272.      your hard disk while looking for the path you wish to check.
  1273.  
  1274.        The current path will always be displayed in the string gadget.
  1275.      You can enter a path manually or you can use the parent and
  1276.      directory buttons to look for the path.
  1277.  
  1278.  
  1279.  
  1280.      
  1281.  
  1282.  
  1283.                          BootX v5.10 User's Manual                  21
  1284.  
  1285.  
  1286.        Enter an empty string in the string gadget or click on Cancel to
  1287.      call off the file check. For more information on how to use the
  1288.      path requester I refer to the ReqTools documentation.
  1289.  
  1290.        Double click on a directory entry or select the OK gadget to begin
  1291.      the file check. During the file check you can press the right
  1292.      mouse button to pause the file check. Press the left mouse button to
  1293.      stop the file check.
  1294.  
  1295.        After the file check BootX will report how many directories,
  1296.      files and crunched files it found. It will also tell you how many
  1297.      files were checked and how many viruses were found.
  1298.  
  1299.        If you asked BootX to generate a file check report you will be
  1300.      given to option to look at it, print it, save it or ignore it.
  1301.      More information about the print and save options can be found in
  1302.      the following sections.
  1303.  
  1304.        Viewing the file check report is the same as viewing a vector
  1305.      check report: click the left mouse button the show the next page,
  1306.      press the right mouse button to abort the viewing.
  1307.  
  1308.  
  1309.                                    NOTE
  1310.  
  1311.           BootX can remember the path you last checked.  Simply
  1312.           save your preferences.  When BootX starts the next
  1313.           time it will show that path as a default.  
  1314.  
  1315.  
  1316.      5.6 Show report     
  1317.  
  1318.        As mentioned in the section about 'Check files' BootX is able to
  1319.      generate a file check report while it's looking for viruses.
  1320.  
  1321.        This menu item allows take another look at the last generated file
  1322.      check report.
  1323.  
  1324.  
  1325.      5.7 Save report     
  1326.  
  1327.        You can also save the last generated file check report to disk for
  1328.      further reference. After you select this option BootX pops up the
  1329.      ReqTools file requester (more information about this requester can
  1330.      be found in the ReqTools documentation). As a default it suggests
  1331.      the filename "LVCReport.doc" but you are free to use any name you
  1332.      like.
  1333.  
  1334.        The file check report is saved as a normal ASCII text file with
  1335.      some standard ANSI codes to enhance the output. Most recent
  1336.      document viewers such as PPMore can handle these ANSI codes.
  1337.  
  1338.  
  1339.      5.8 Print report     
  1340.  
  1341.        You can print the last generated file check report from within
  1342.  
  1343.  
  1344.      
  1345.  
  1346.  
  1347.                          BootX v5.10 User's Manual                  22
  1348.  
  1349.  
  1350.      BootX using this menu item.
  1351.  
  1352.  
  1353.                                    NOTE
  1354.  
  1355.           If you have to wait a long time (about 10 seconds) and
  1356.           nothing happens, please check that your printer is
  1357.           turned on and if so that it is on-line.  BootX will
  1358.           not be able to report an error until the default
  1359.           time-out period is passed (usually 30 seconds) or
  1360.           until the user put the printer on-line.  
  1361.  
  1362.  
  1363.  
  1364.      5.9 Check disk     
  1365.  
  1366.        When you select this menu item, BootX will put up a requester
  1367.      that allows you to specify which actions BootX should perform
  1368.      when performing a complete disk check.
  1369.  
  1370.              Check bootblock: checks the bootblock
  1371.  
  1372.              Check blocks   : checks all the disk blocks
  1373.  
  1374.              Check files    : checks all the files
  1375.  
  1376.        All these actions will be performed on the disk in the current
  1377.      drive. Select OK to begin with the disk check. Click on the window
  1378.      close gadget to cancel the disk check.
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.      
  1409.  
  1410.  
  1411.                          BootX v5.10 User's Manual                  23
  1412.  
  1413.  
  1414.      Chapter 6 The ToolBox Menu   
  1415.  
  1416.        In this menu you will find some utilities that might come in handy
  1417.      during your work.
  1418.  
  1419.      6.1 Filter      
  1420.  
  1421.        The Filter utility allows you to create a filter of path names
  1422.      which BootX will ignore during a file check. The paths that are
  1423.      part of a filter typically contain only data files like documents,
  1424.      modules, IFF drawings, include files or other binary files.
  1425.  
  1426.        Programmers might want to put their Include and Fd directories in
  1427.      the filter. The Fonts directory is another good candidate.
  1428.  
  1429.        Make sure you have checked the Filter checkbox in the Check Files
  1430.      preference requester or the Filter will not be used during a file
  1431.      check.
  1432.  
  1433.  
  1434.                                    NOTE
  1435.  
  1436.           The filter can be a mixed blessing. It will speed up
  1437.           file checks since entire directories will be skipped.
  1438.           However if you add a path to the filter that contains
  1439.           executables and one of the executables is infected by
  1440.           a virus it will not be found. Be carefull.  
  1441.  
  1442.  
  1443.  
  1444.      6.1.1 New      
  1445.  
  1446.        Click this gadget to start a new filter.
  1447.  
  1448.  
  1449.      6.1.2 Add      
  1450.  
  1451.        When you click on the Add gadget BootX will present you with a
  1452.      directory requester. Walk through your directory tree until you
  1453.      are in the directory you wish to filter. Select OK when done. The
  1454.      newly selected path will show up in the Filter listview.
  1455.  
  1456.        If you have selected an entry from the Filter listview it will be
  1457.      used as starting point of your tree travels.
  1458.  
  1459.  
  1460.      6.1.3 Edit      
  1461.  
  1462.        This gadget can only be selected when you have clicked on one of
  1463.      the Filter listview entries. BootX will present you with a
  1464.      directory requester with the selected entry as starting point of
  1465.      your tree walk. This allows you to edit existing path filters.
  1466.  
  1467.  
  1468.      6.1.4 Remove      
  1469.  
  1470.  
  1471.  
  1472.      
  1473.  
  1474.  
  1475.                          BootX v5.10 User's Manual                  24
  1476.  
  1477.  
  1478.        After you have selected an entry from the Filter listview, the
  1479.      Remove gadget will become enabled. Click on it to remove the
  1480.      current selected filter entry.
  1481.  
  1482.  
  1483.      6.1.5 OK      
  1484.  
  1485.        Select the OK gadget to finish editing the path filter.
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.      
  1537.  
  1538.  
  1539.                          BootX v5.10 User's Manual                  25
  1540.  
  1541.  
  1542.      Chapter 7 The Bootblocks Menu   
  1543.  
  1544.      7.1 Load/Save      
  1545.  
  1546.        BootX can save the bootblock in the buffer as a file to any drive.
  1547.      'Save' can be used to save the bootblocks of games, mega demos and
  1548.      other programs to a separate data disk.
  1549.  
  1550.        In case of a virus attack or a bad disk you can load the
  1551.      previously saved bootblock back in the buffer and write it back to
  1552.      the original disk.
  1553.  
  1554.        'Load' will only allow you to load a file that contains a valid
  1555.      bootblock.  It checks if it is an OldFileSystem or FastFileSystem
  1556.      bootblock and then recalculates the checksum of the bootblock.
  1557.  
  1558.        When the bootblock checksum is wrong, BootX will ask you if you
  1559.      want to repair it.  If you select Yes, BootX repairs the bootblock
  1560.      checksum of the loaded copy.
  1561.  
  1562.        If the loading was succesful BootX will try to identify the
  1563.      bootblock.  If the file you loaded did not contain a valid
  1564.      bootblock, BootX will tell you.
  1565.  
  1566.  
  1567.      7.2 Learn      
  1568.  
  1569.        This menu item is turned on when BootX does not recognize the
  1570.      bootblock in its buffer. The bootblock can either be read from
  1571.      disk (using the Read Bootblock gadget) or be loaded using the
  1572.      Bootblocks/Load menu item.
  1573.  
  1574.        If you want to teach an unrecognized bootblock to BootX use this
  1575.      menu item. BootX will pop up a list requester showing the contents
  1576.      of the current Brain file. Simply enter the name for the unknown
  1577.      bootblock in the string gadget under the list. If the name you
  1578.      entered already exists BootX will ask you if you'd like to use the
  1579.      name anyway. This practise is not encouraged. Try to make your
  1580.      names unique. It'll help you identify a bootblock much easier
  1581.      later on.
  1582.  
  1583.        After BootX has learned the bootblock it will display its name in
  1584.      the message window in white. This way you know that it is the
  1585.      Brain file that recognized the bootblock and not the Recog file.
  1586.  
  1587.  
  1588.                                    NOTE
  1589.  
  1590.           Only the Brain file can be updated by a user.  The
  1591.           Recog files will be periodically released by me.  The
  1592.           Recog file always takes precedence over the Brain
  1593.           file.  That is, if you teach BootX a bootblock as "New
  1594.           Name" and some time later it is identified as "Some
  1595.           new virus" you know that I have added the bootblock to
  1596.           the Recog file.  Please send me any bootblock that
  1597.           BootX does not recognize yet.  This way the Recog file
  1598.  
  1599.  
  1600.      
  1601.  
  1602.  
  1603.                          BootX v5.10 User's Manual                  26
  1604.  
  1605.  
  1606.           will always be up to date.  
  1607.  
  1608.  
  1609.  
  1610.      7.3 Show again     
  1611.  
  1612.        Use this menu item to refresh the display after it has been erased
  1613.      or been used by some other BootX function.
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.      
  1665.  
  1666.  
  1667.                          BootX v5.10 User's Manual                  27
  1668.  
  1669.  
  1670.      Chapter 8 The BBLib Menu   
  1671.  
  1672.        When BootX is started it will look for a file called BootX.BBLib.
  1673.      This Bootblock library contains custom bootblocks that you can use
  1674.      instead of the standard OldFileSystem or FastFileSystem
  1675.      bootblocks.
  1676.  
  1677.        With the Bootblock library system you can create several different
  1678.      libraries that contain your collection games, demo or utility
  1679.      bootblocks.  The libraries are much easier to maintain than
  1680.      several single files.  If one of your autobooting game or demo
  1681.      disks get infected by a bootvirus, you can always use the copy you
  1682.      saved in your library to restore the disk.
  1683.  
  1684.        You can install any bootblock in the library by selecting it using
  1685.      the 'Show installable bootblock' gadget and then clicking on the
  1686.      'Install' gadget.
  1687.  
  1688.  
  1689.                                    NOTE
  1690.  
  1691.           BootX can remember the name of the bootblock library
  1692.           and where it came from.  After loading a BBLib file
  1693.           from a different path or with a different filename
  1694.           simply save your preferences.  When BootX starts the
  1695.           next time it will try to load the BBLib file with that
  1696.           path and filename.  
  1697.  
  1698.  
  1699.  
  1700.      8.1 New      
  1701.  
  1702.        When you select the BBLib/New menu item the current Bootblock
  1703.      library in memory (if any) will be cleared so that you can started
  1704.      a new one.
  1705.  
  1706.  
  1707.                                    NOTE
  1708.  
  1709.           BootX always adds four built-in bootblocks when you
  1710.           start a new BootBlock library.  These bootblock are
  1711.           the standard OldFileSystem and the standard
  1712.           FastFileSystem bootblock (normal and international
  1713.           version) as they would be installed by the Install
  1714.           command from the C directory.  These two bootblocks
  1715.           will not be saved with your Bootblock library.  You
  1716.           can tell which bootblocks are built-in by the little
  1717.           dot that appears in the bootblock list.  More
  1718.           bootblocks will be added when the need arises.  
  1719.  
  1720.  
  1721.  
  1722.      8.2 Load      
  1723.  
  1724.        With the Load menu item you can load any Bootblock library.  You
  1725.      could for instance have a separate bootblock library for game,
  1726.  
  1727.  
  1728.      
  1729.  
  1730.  
  1731.                          BootX v5.10 User's Manual                  28
  1732.  
  1733.  
  1734.      demo or utility bootblocks.
  1735.  
  1736.  
  1737.      8.3 Save      
  1738.  
  1739.        The Save menu item allows you to save the current Bootblock
  1740.      library.  This menu item will only be turned on when the Bootblock
  1741.      library was actually changed.
  1742.  
  1743.  
  1744.      8.4 Show      
  1745.  
  1746.        You can take a look at the contents of the current Bootblock
  1747.      library by selecting the BBLib/Show menu item.  BootX will pop up a
  1748.      list requester showing you the names of the bootblocks.
  1749.  
  1750.  
  1751.      8.5 Merge      
  1752.  
  1753.        You can share your Bootblock libraries with your friends. The
  1754.      Merge menu item allows you to merge the contents of a Bootblock
  1755.      library with the one in memory.
  1756.  
  1757.        BootX will scan the complete library, ignoring duplicates and
  1758.      adding any new bootblock not yet found in memory.
  1759.  
  1760.  
  1761.      8.6 Add bootblock     
  1762.  
  1763.        Use this menu item to add the bootblock currently in the bootblock
  1764.      buffer to the Bootblock library.  BootX will pop up a list
  1765.      requester with a string gadget.  Enter the name of the bootblock
  1766.      in the string gadget and click on OK (or press return).
  1767.  
  1768.        BootX checks to see if that name already exists and if it does it
  1769.      will ask you if you really want to add the bootblock.
  1770.  
  1771.  
  1772.      8.7 Delete bootblock     
  1773.  
  1774.        You can use this menu item to delete a bootblock from the
  1775.      Bootblock library.
  1776.  
  1777.  
  1778.                                    NOTE
  1779.  
  1780.           You can not delete a built-in bootblock. BootX will
  1781.           warn you if you try to do so.  
  1782.  
  1783.  
  1784.  
  1785.      8.8 Rename bootblock     
  1786.  
  1787.        You can use this menu item to rename a bootblock in the
  1788.      Bootblock library. Select the one you'd like to rename by clicking
  1789.      on its name and then clicking on the OK gadget (or by double
  1790.  
  1791.  
  1792.      
  1793.  
  1794.  
  1795.                          BootX v5.10 User's Manual                  29
  1796.  
  1797.  
  1798.      clicking the name)
  1799.  
  1800.        BootX will then ask you to enter the new name of the bootblock.
  1801.  
  1802.  
  1803.                                    NOTE
  1804.  
  1805.           You can not rename a built-in bootblock. BootX will
  1806.           warn you if you try to do so.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.      
  1857.  
  1858.  
  1859.                          BootX v5.10 User's Manual                  30
  1860.  
  1861.  
  1862.      Chapter 9 The Brain Menu   
  1863.  
  1864.        At startup time BootX looks for a file called BootX.Brain.  This
  1865.      Brainfile contains all the bootblocks you have taught BootX using
  1866.      the Bootblock/Learn menu item.
  1867.  
  1868.        This Brainfile complements the knowledge base of BootX by letting
  1869.      BootX recognize any new bootblock that are not yet recognized by
  1870.      the BootX.Recog file.
  1871.  
  1872.  
  1873.                                    NOTE
  1874.  
  1875.           If you find new bootblocks that BootX does not yet
  1876.           recognize please send them to me so that I can update
  1877.           the Recog file. BootX will always give precedence to
  1878.           the conclusion of the Recog file when it tries to
  1879.           recognize a bootblock.  
  1880.  
  1881.  
  1882.  
  1883.      9.1 New      
  1884.  
  1885.        When you select the Brain/New menu item the current Brainfile in
  1886.      memory (if any) will be cleared so that you can started a new one.
  1887.  
  1888.  
  1889.      9.2 Load      
  1890.  
  1891.        With the Load menu item you can load any Brainfile.
  1892.  
  1893.  
  1894.                                    NOTE
  1895.  
  1896.           BootX can remember the name of the Brain file and
  1897.           where it came from.  After loading a Brain file from a
  1898.           different path or with a different filename simply
  1899.           save your preferences.  When BootX starts the next
  1900.           time it will try to load the Brain file with that path
  1901.           and filename.  
  1902.  
  1903.  
  1904.  
  1905.      9.3 Save      
  1906.  
  1907.        The Save menu item allows you to save the current Brainfile.  This
  1908.      menu item will only be turned on when the Brainfile has been
  1909.      changed during the run of the program.
  1910.  
  1911.  
  1912.      9.4 Show      
  1913.  
  1914.        You can take a look at the contents of the current Brainfile by
  1915.      selecting the Brain/Show menu item.  BootX will pop up a list
  1916.      requester showing you the names of the bootblocks BootX recognizes
  1917.      in addition to the Recog file.
  1918.  
  1919.  
  1920.      
  1921.  
  1922.  
  1923.                          BootX v5.10 User's Manual                  31
  1924.  
  1925.  
  1926.  
  1927.  
  1928.      9.5 Merge      
  1929.  
  1930.        You can share your Brainfiles with your friends.  The Merge menu
  1931.      item allows you to merge the contents of a Brainfile with the one
  1932.      in memory.
  1933.  
  1934.        BootX will scan the complete Brainfile, ignoring duplicates and
  1935.      adding any new bootblock not yet found in memory.
  1936.  
  1937.  
  1938.      9.6 Delete Brain cell    
  1939.  
  1940.        You can use this menu item to delete a bootblock from the current
  1941.      Brainfile.
  1942.  
  1943.  
  1944.      8.8 Rename Brain cell    
  1945.  
  1946.        You can use this menu item to rename a bootblock in the current
  1947.      Brainfile.  Select the one you'd like to rename by clicking on its
  1948.      name and then clicking on the OK gadget (or by double clicking the
  1949.      name)
  1950.  
  1951.        BootX will then ask you to enter the new name of the bootblock.
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.      
  1985.  
  1986.  
  1987.                          BootX v5.10 User's Manual                  32
  1988.  
  1989.  
  1990.      Chapter 10 The Preferences Menu   
  1991.  
  1992.      10.1 Edit...      
  1993.  
  1994.        Use Preferences/Edit to change some settings of BootX.  As of
  1995.      version 5.10 all your settings are being kept in a file called
  1996.      'BootX.prefs' which can be found in the directory 'BootX' of device
  1997.      ENV: and ENVARC:.
  1998.  
  1999.        The file is a plain ASCII file which can be read using any text
  2000.      reader or modified using any text editor. Be carefull though
  2001.      because the parsing routines are not very smart and presume a
  2002.      couple of things. It is better to change your settings using BootX
  2003.      and to save them.
  2004.  
  2005.  
  2006.      10.1.1 Virus alarm     
  2007.  
  2008.        BootX can grab your attention when it finds a virus by using one
  2009.      of the following three possibilities:
  2010.  
  2011.         (1) None: BootX will remain silent when it finds a virus.
  2012.  
  2013.         (2) System beep:  BootX will DisplayBeep the BootX screen.  If you
  2014.         have installed a sample using the Sound preferences editor this is
  2015.         what you'll hear.  Otherwise the colors of the BootX screen will
  2016.         be flashed.
  2017.  
  2018.         (3) Play sample:  BootX will play the sample found in the file
  2019.         BootX.Alarm.  This file is loaded at startup time (when found).
  2020.         The file must use the IFF 8SVX file format.  Most if not all
  2021.         sample creating programs support this file format.
  2022.  
  2023.  
  2024.      10.1.2 Save icons     
  2025.  
  2026.        Check this settings if you'd like BootX to create an icon for any
  2027.      of the files it saves.
  2028.  
  2029.  
  2030.      10.1.3 Detect diskchange     
  2031.  
  2032.        If this option is turned on, BootX will know when you insert a
  2033.      disk in any of the available disk drives.  That drive will be made
  2034.      current and BootX will try to read the bootblock of the disk you
  2035.      just inserted.
  2036.  
  2037.        To make BootX read a bootblock of a disk when this settings is
  2038.      turned off, make the drive current that contains the disk you'd
  2039.      like to check and click on the Read Bootblock gadget.
  2040.  
  2041.  
  2042.      10.1.4 Check disk-validator     
  2043.  
  2044.        The disk-validator used to be a part of AmigaDOS 1.2/1.3 that
  2045.      could be found as a file called Disk-Validator in the L drawer of
  2046.  
  2047.  
  2048.      
  2049.  
  2050.  
  2051.                          BootX v5.10 User's Manual                  33
  2052.  
  2053.  
  2054.      a boot disk.
  2055.  
  2056.        There are some viruses that make use of the feature to infect your
  2057.      computer and disks.  The disk-validator would be loaded
  2058.      automatically when AmigaDOS detected a non validated disk.  The
  2059.      disk-validator would then be put to work to repair the disk.
  2060.  
  2061.        When this option is turned on BootX will check if such a file
  2062.      exists on your disk after it has tested the bootblock.  BootX will
  2063.      check if it has been infected before a possible virus gets a
  2064.      chance to get in your system.  BootX does this by not using
  2065.      AmigaDOS but directly manipulating the disk.
  2066.  
  2067.        To have the most benefit of this feature, also use the Lock Drive
  2068.      gadget. Read also section 11.1 "How to kill disk-validator
  2069.      viruses...".
  2070.  
  2071.  
  2072.                                    NOTE
  2073.  
  2074.           KickStart 2.0 does not need the disk-validator anymore
  2075.           since the repair code has been built in. This also
  2076.           means that Amigas running KickStart 2.0 or later can
  2077.           not be infected by inserting a disk that contains one
  2078.           of those 'disk-validator viruses'.  
  2079.  
  2080.  
  2081.  
  2082.      10.1.5 Crunch      
  2083.  
  2084.        BootX crunch the Bootblock library and the Brain file before
  2085.      saving them. It uses the powerpacker.library (© Nico François) to
  2086.      crunch the files.
  2087.  
  2088.        The 'Never' setting will never crunch any files.
  2089.  
  2090.        The 'Ask' setting will cause BootX to ask you every time you save
  2091.      the Bootblock library or the Brain file if you'd like BootX to
  2092.      crunch them.
  2093.  
  2094.        The 'Always' setting will ask no questions and will always crunch
  2095.      before saving.
  2096.  
  2097.  
  2098.                                    NOTE
  2099.  
  2100.           Sometimes BootX will not be able to crunch your files.
  2101.           BootX will typically report this as a buffer overflow.
  2102.           This is because your data files have to much entropy.
  2103.           This is neither a bug in BootX nor a bug in the
  2104.           powerpacker.library. In this case you will have to
  2105.           turn off crunching and save the file uncrunched.  
  2106.  
  2107.  
  2108.  
  2109.      10.1.6 Iconify at startup    
  2110.  
  2111.  
  2112.      
  2113.  
  2114.  
  2115.                          BootX v5.10 User's Manual                  34
  2116.  
  2117.  
  2118.  
  2119.        When this setting is on (checked) BootX will start running in an
  2120.      iconified state. For more details read section 4.4.
  2121.  
  2122.  
  2123.      10.1.7 Check memory at startup   
  2124.  
  2125.        If this setting is checked BootX will check the memory of the
  2126.      Amiga for viruses every time it gets started or after it returns
  2127.      from an iconified state.  It is a good idea to have this setting
  2128.      turned on.
  2129.  
  2130.        You can always force BootX to recheck your memory using the
  2131.      Check/Check memory menu item.
  2132.  
  2133.  
  2134.      10.8 Check vectors at startup   
  2135.  
  2136.        This option works the same as the 'Check memory at startup'
  2137.      option. Turn it on if you'd like BootX perform a complete vector
  2138.      check every time you start BootX.
  2139.  
  2140.  
  2141.                                    NOTE
  2142.  
  2143.           In order to let you read any error message that are
  2144.           shown at startup time (for example if something goes
  2145.           wrong when trying to load the Recog file) BootX will
  2146.           look at your settings right before starting the vector
  2147.           check.  If you have turned on the 'Pause after page'
  2148.           setting (see further), BootX will ask you to click the
  2149.           left mouse button before it shows you the vector check
  2150.           report.  
  2151.  
  2152.  
  2153.  
  2154.      10.9 Pause after page    
  2155.  
  2156.        Turning this setting on causes BootX to pause the screen output
  2157.      every time a full screen page has been shown. See also the note in
  2158.      section 10.8.
  2159.  
  2160.  
  2161.      10.10 Wrap words     
  2162.  
  2163.        Sometimes the output of BootX is longer than will fit in the
  2164.      window. With this option you control wether BootX cuts off the
  2165.      output or wraps the remaining part on the next line.
  2166.  
  2167.  
  2168.      10.11 Display Mode     
  2169.  
  2170.        BootX can use any screen mode that the Monitors database offers to
  2171.      you. If you click this gadget BootX will put up the ReqTools
  2172.      display requester allowing you to choose which screen mode will be
  2173.      used.
  2174.  
  2175.  
  2176.      
  2177.  
  2178.  
  2179.                          BootX v5.10 User's Manual                  35
  2180.  
  2181.  
  2182.  
  2183.        If you select a new display mode your choice will become active
  2184.      immediately.
  2185.  
  2186.  
  2187.      10.12 Palette      
  2188.  
  2189.        Clicking this gadget makes BootX put up the ReqTools palette
  2190.      requester. You can use it to customize the BootX screen colors.
  2191.  
  2192.  
  2193.      10.2 Load/Save      
  2194.  
  2195.        Use these menu items to load or save the current settings from or
  2196.      to the BootX.prefs file.
  2197.  
  2198.        After a succesfull load BootX will close and reopen its screen
  2199.      even if you did not change the display settings.
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.      
  2241.  
  2242.  
  2243.                          BootX v5.10 User's Manual                  36
  2244.  
  2245.  
  2246.      Chapter 11 Hints tips and tricks  
  2247.  
  2248.      11.1 How to kill disk-validator viruses...  
  2249.  
  2250.        First make sure that your memory is clear of any virus.  You can
  2251.      do this by turning of your Amiga for a few seconds and then
  2252.      booting from a NON-INFECTED disk.  Always make sure all the disks
  2253.      you insert are WRITE-PROTECTED unless it contains a disk-validator
  2254.      virus you want to kill.
  2255.  
  2256.        Start BootX and lock the current drive by clicking on the Lock
  2257.      gadget next to the drive cycle gadgets.  This prevents AmigaDOS
  2258.      and the Workbench from accessing the disks you are about to
  2259.      insert.
  2260.  
  2261.        Insert the infected disk into the current drive and click on the
  2262.      Read gadget.  BootX now reads the bootblock and checks the file
  2263.      called 'disk-validator'.  This file can be found in the L drawer
  2264.      of the disk.
  2265.  
  2266.        If BootX does not check the disk-validator, make sure that the
  2267.      'Check Disk-Validator' checkbox is checked in the Preferences
  2268.      requester.
  2269.  
  2270.        When BootX finds a disk-validator virus, it will ask you if it
  2271.      should kill the virus.  If you select Yes, BootX destroys the
  2272.      complete virus code and makes a harmless executable program of it
  2273.      that does nothing than set the dos error code to -1.
  2274.  
  2275.        Next you are given the advice to repair the disk using the 'Check
  2276.      blocks' menu item.
  2277.  
  2278.        As a last step you need to copy an UNINFECTED disk-validator file
  2279.      into the L drawer of the repaired disk.  This step could not be
  2280.      automated because the Disk-Validator file is copyrighted by
  2281.      Commodore Amiga.
  2282.  
  2283.  
  2284.      11.2 Using BootX with little memory  
  2285.  
  2286.        BootX has become quite a large program over the years and together
  2287.      with its support files it can occupy over 200K of RAM.
  2288.  
  2289.        Don't generate a file check report when checking your hard disk.
  2290.      The file check report for hard disks with 5000+ files can grow
  2291.      easily larger than 200K.
  2292.  
  2293.        Clear the Brain and BBLib files using the 'BBLib New' and 'Brain
  2294.      New' menu items respectively.
  2295.  
  2296.        Delete or rename the file 'BootX.Alarm'. It contains the sample
  2297.      BootX uses to alert the user if it finds a virus. Use the System
  2298.      Beep option of the Preference requester instead.
  2299.  
  2300.        Use the lowest possible screen mode the Display Mode requester has
  2301.      to offer. Specify the screen dimension as low as possible.
  2302.  
  2303.  
  2304.      
  2305.  
  2306.  
  2307.                          BootX v5.10 User's Manual                  37
  2308.  
  2309.  
  2310.  
  2311.  
  2312.      11.3 Copying bootblocks with one drive  
  2313.  
  2314.        Turn off the Detect Diskchange setting in the Preference
  2315.      requester.
  2316.  
  2317.        Insert your disk in the disk drive.
  2318.  
  2319.        Click on the Read Bootblock gadget. The bootblock will now be read
  2320.      into the BootX buffer and will be shown in the main window.
  2321.  
  2322.        Remove the disk from your disk drive and insert the disk you want
  2323.      the bootblock copied to.
  2324.  
  2325.        Click on the Write Bootblock gadget. BootX will now write its
  2326.      buffer to the newly inserted disk.
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.      
  2369.  
  2370.  
  2371.                          BootX v5.10 User's Manual                  38
  2372.  
  2373.  
  2374.      Appendix A Glossary     
  2375.  
  2376.                                      A
  2377.  
  2378.      Agnus        
  2379.        Amiga custom chip. Takes care of the memory management and the DMA
  2380.        and coprocessor usage.
  2381.  
  2382.        Amiga        
  2383.          Spanish: female friend
  2384.  
  2385.        AmigaDOS        
  2386.          The disk operating system (DOS) used by Amiga computers.
  2387.  
  2388.        ANSI        
  2389.          American National Standards Institute. A set of codes to perform
  2390.          special functions like printing text in bold.
  2391.  
  2392.        appicon        
  2393.          An icon on the Workbench that allows the user to pass arguments to
  2394.          an application. BootX puts an AppIcon on the Workbench when you
  2395.          select the Project/Iconify menu item.
  2396.  
  2397.        application gadget       
  2398.          A graphics image that appears within a program which can be
  2399.          manipulated with the mouse to perform a certain function.
  2400.  
  2401.        ASCII        
  2402.          American Standard Code for Information Interchange. The code set
  2403.          that the Amiga usage to represent letter and figures.
  2404.  
  2405.        assembler        
  2406.          A programming language
  2407.  
  2408.        attributes        
  2409.          A series of flags stored with every file. Attributes indicate file
  2410.          type and control the file operations (read, write, delete, etc.)
  2411.          Also protection bits.
  2412.  
  2413.                                       B
  2414.  
  2415.        BBLib        
  2416.          See bootblock library.
  2417.  
  2418.        boot        
  2419.          The startup process for a computer. It comes from the expression
  2420.          "pulling yourself up by the bootstraps."
  2421.  
  2422.        bootblock        
  2423.          Part of a disk or hard disk that is read first by the Amiga to
  2424.          initialize or recognize the disk.  Usually contains a small
  2425.          program (disks) or parameters (hard disk).
  2426.  
  2427.        bootblock library       
  2428.          A custom file of BootX that contain several bootblocks that the
  2429.          user can install on his disks.
  2430.  
  2431.  
  2432.      
  2433.  
  2434.  
  2435.                          BootX v5.10 User's Manual                  39
  2436.  
  2437.  
  2438.  
  2439.        bootvirus        
  2440.          Virus that hides in the bootblock of a disk. Only gets activated
  2441.          when you boot from the infected disk.
  2442.  
  2443.        Brain file       
  2444.          Supplementary recognition information that the user has taught
  2445.          BootX using the Bootblocks/Learn menu item.
  2446.  
  2447.        bug        
  2448.          A mistake in a program
  2449.  
  2450.                                       C
  2451.  
  2452.        check box       
  2453.          A gadget used to let a user turn an option on or off. When a check
  2454.          mark appears in the box, the selection is considered to be "on."
  2455.  
  2456.        Chip RAM       
  2457.          The area of RAM accessible to the Amiga's custom chip set used for
  2458.          graphics and sound data.
  2459.  
  2460.        CLI (Command Line Interface)     
  2461.          A means of communicating with the Amiga by issuing commands from
  2462.          the keyboard.
  2463.  
  2464.        click        
  2465.          To press and release a mouse button
  2466.  
  2467.        close gadget       
  2468.          A system gadget used to close windows. It appears in the upper
  2469.          left corner of the window.
  2470.  
  2471.        cold reboot       
  2472.          To reset the Amiga by turning the power off, waiting 20 seconds,
  2473.          and then turning it on again.
  2474.  
  2475.        CPU        
  2476.          Central Processing Unit. The micro processor that executes the
  2477.          instruction that make up a program. The Amiga either has a
  2478.          MC68000, MC68020, MC68030 or MC68040 CPU.
  2479.  
  2480.        Crunch        
  2481.          Transforming data in such a way that the result uses less memory
  2482.          or disk space.  BootX optionally uses the PowerPacker library to
  2483.          crunch or decrunch the data it uses.
  2484.  
  2485.        current drive       
  2486.          The drive that will be used by default for any BootX operation
  2487.          unless the user specifies another.
  2488.  
  2489.        cycle gadget       
  2490.          An application gadget that allows the user to select one of
  2491.          several options. One option is displayed at a time and, as the
  2492.          gadget is selected, the other options become visible. The
  2493.          displayed option is the selected option.
  2494.  
  2495.  
  2496.      
  2497.  
  2498.  
  2499.                          BootX v5.10 User's Manual                  40
  2500.  
  2501.  
  2502.  
  2503.                                       D
  2504.  
  2505.        default        
  2506.          Initial setting, what will be used if nothing else is supplied.
  2507.  
  2508.          delete        
  2509.            To erase or discard a file, buffer, or other stored item.
  2510.  
  2511.          device        
  2512.            A physical mechanism, such as a disk drive, used as a source or
  2513.            destination for information
  2514.  
  2515.            directory        
  2516.              A subdivision in a computer's filing system. Directories are
  2517.              represented on the Workbench as drawer icons.
  2518.  
  2519.            disk        
  2520.              A medium for storage of computer data.
  2521.  
  2522.            disk-validator        
  2523.              An extension of the pre-2.0 AmigaDOS. It was loaded from disk
  2524.              whenever the user inserted a bad or corrupted disk. The
  2525.              disk-validator tried to repair the disk.
  2526.  
  2527.            double-click        
  2528.              To press and release the mouse's selection button twice.
  2529.  
  2530.            drawer        
  2531.              See 'directory'
  2532.  
  2533.            drive name       
  2534.              The name assigned to a floppy disk drive or hard disk such as
  2535.              Work:, WB2.x: or DF0:. It is the same as the device name.
  2536.  
  2537.                                         E
  2538.  
  2539.            executable        
  2540.              A type of file that contains program instructions that the Amiga
  2541.              can use the execute a program. Executables are the prime target
  2542.              for linkviruses.
  2543.  
  2544.                                         F
  2545.  
  2546.            FastFileSystem (FFS)       
  2547.              An enhanced Amiga file system usable with both floppy and hard
  2548.              disks. A volume is formatted as either FFS or OldFileSystem (OFS).
  2549.              The advantages of FFS are increased storage capacity and faster
  2550.              access of files.
  2551.  
  2552.  
  2553.            Fast RAM       
  2554.              General memory used by programs and data, as opposed to Chip RAM.
  2555.  
  2556.            file        
  2557.              A collection of data
  2558.  
  2559.  
  2560.      
  2561.  
  2562.  
  2563.                          BootX v5.10 User's Manual                  41
  2564.  
  2565.  
  2566.  
  2567.            filename        
  2568.              The name by which a program or a data file is known to the Amiga
  2569.              when you want to access it on disk or hard disk.
  2570.  
  2571.            FPU        
  2572.              Floating Point Unit. Special purpose micro processor to speed up
  2573.              calculations using real numbers. The FPU's available for the Amiga
  2574.              are called MC68881 and MC68882.
  2575.  
  2576.            Freeware        
  2577.              In contrast with true public domain the author keeps a copyright
  2578.              on his product. Any further right that come with it are wavered.
  2579.              Freeware software may be copied as long as no copying fee is
  2580.              charged.
  2581.  
  2582.  
  2583.                                         G
  2584.  
  2585.            gadget        
  2586.              Any graphics image that can be found in a window or on a screen
  2587.              that can be manipulated with the mouse to perform a certain
  2588.              function.
  2589.  
  2590.            graphics memory       
  2591.              See Chip RAM
  2592.  
  2593.            GUI        
  2594.              Graphical User Interface
  2595.  
  2596.                                         H
  2597.  
  2598.            hot key       
  2599.              A special key or key combination that triggers a certain action.
  2600.              BootX uses a hot key to uniconify or to bring its screen to the
  2601.              front.
  2602.  
  2603.                                         I
  2604.  
  2605.            icon        
  2606.              An image appearing on the screen to represent a disk, drawer,
  2607.              project or tool. Icons can be moved and selected with the mouse to
  2608.              allow you to work with the items they represent.
  2609.  
  2610.            IFF 8SVX       
  2611.              A file format following the Interchange File Format (IFF)
  2612.              specifications.  It's purpose is to allow easy interchange of 8
  2613.              bit sound samples.
  2614.  
  2615.                                         K
  2616.  
  2617.            K        
  2618.              Kilobyte. 1024 bytes.
  2619.  
  2620.            KickStart        
  2621.              Software that is read from disk and used to boot the Amiga. Also
  2622.  
  2623.  
  2624.      
  2625.  
  2626.  
  2627.                          BootX v5.10 User's Manual                  42
  2628.  
  2629.  
  2630.              refers to the portion of the OS that is in ROM. BootX requires at
  2631.              least version 2.04 of the KickStart.
  2632.  
  2633.                                         L
  2634.  
  2635.            library        
  2636.              A related set of functions that can be shared by various programs.
  2637.              BootX uses for example the PowerPacker.library to load and save
  2638.              crunched data.
  2639.  
  2640.            linkvirus        
  2641.              A virus that spreads itself by linking its own code to other
  2642.              programs. When you run an infected program the virus hides itself
  2643.              in memory before allowing the program to execute. There it waits
  2644.              to infect other programs.
  2645.  
  2646.                                         M
  2647.  
  2648.            MB        
  2649.              Megabyte. 1,048,576 bytes
  2650.  
  2651.            MMU        
  2652.              Memory Management Unit. Special purpose micro processor that can
  2653.              efficiently control the memory of the Amiga. The MMU available for
  2654.              the Amiga is the MC68851.
  2655.  
  2656.  
  2657.            menu        
  2658.              A list of on-screen options, displayed by using the menu button,
  2659.              from which users can choose commands that control a program.
  2660.  
  2661.            menu button       
  2662.              The right mouse button
  2663.  
  2664.            menu item       
  2665.              An option that appears in a menu
  2666.  
  2667.            multitasking        
  2668.              Ability of the operating system to run multiple programs at the
  2669.              same time.
  2670.  
  2671.                                         O
  2672.  
  2673.            OldFileSystem (OFS)       
  2674.              The file system used by pre-2.0 AmigaDOS.
  2675.  
  2676.                                          P
  2677.  
  2678.              parallel        
  2679.                A parallel port can transmit or receive 8 bits at a time where as
  2680.                a serial port can only transmit 1 bit at a time
  2681.  
  2682.              path        
  2683.                The series of device, directory and subdirectory names that
  2684.                defines the location of a file.
  2685.  
  2686.  
  2687.  
  2688.      
  2689.  
  2690.  
  2691.                          BootX v5.10 User's Manual                  43
  2692.  
  2693.  
  2694.              Paula        
  2695.                Amiga custom chip. Takes care of the sound production, the
  2696.                diskcontroller and the serial port.
  2697.  
  2698.              PowerPacker.library        
  2699.                A shared library written by Nico François. It allows BootX to read
  2700.                and write crunched files using the PowerPacker crunching
  2701.                algorythm.
  2702.  
  2703.              processor        
  2704.                See CPU
  2705.  
  2706.              protection bits       
  2707.                See attributes
  2708.  
  2709.              public domain       
  2710.                Software that carries no copyright at all. Public domain software
  2711.                can be copied and used without restrictions. Often misused term
  2712.                for Freeware or Shareware
  2713.  
  2714.                                          R
  2715.  
  2716.              RAM        
  2717.                Random Access Memory.  Part of the Amiga's internal memory that
  2718.                can be used for data storage and is directly accessible by the
  2719.                CPU.  Data in RAM is lost when the Amiga is rebooted or powered
  2720.                off.
  2721.  
  2722.              Ranger memory       
  2723.                Part of the internal memory that gets added to the system at reset
  2724.                time. It can not be used for graphics nor for DMA access. Internal
  2725.                A500 memory expansion is usually Ranger memory.
  2726.  
  2727.              read only       
  2728.                If a disk status or a file attribute is Read Only, the user can
  2729.                only look at the contents of the disk or the file without
  2730.                modifying it.
  2731.  
  2732.              reboot        
  2733.                To reset the Amiga by pressing the keys Ctrl, Left-Amiga and
  2734.                Right-Amiga simultaneously. Also called a warm boot.
  2735.  
  2736.              Recog file       
  2737.                The file that contains all the information that BootX needs to
  2738.                recognize and kill boot- and linkviruses.
  2739.  
  2740.              ReqTools.library        
  2741.                A shared library written by Nico François. It has special
  2742.                functions to create the several kinds of requesters that BootX
  2743.                uses.
  2744.  
  2745.              requester        
  2746.                A window that allows the user to control options, access files or
  2747.                confirm actions.
  2748.  
  2749.              resmodule        
  2750.  
  2751.  
  2752.      
  2753.  
  2754.  
  2755.                          BootX v5.10 User's Manual                  44
  2756.  
  2757.  
  2758.                Resident module.  Part of the Amiga's extendable open-ended
  2759.                operating system.
  2760.  
  2761.              ROM        
  2762.                Read Only Memory. Acts theoreticaly the same as RAM but can only
  2763.                be read. Usually contains the main part of the operating system.
  2764.  
  2765.              root directory       
  2766.                The main directory of a volume. All other directories are created
  2767.                in the root. The word comes from the analogy between the structure
  2768.                of the file system and the shape of a tree.
  2769.  
  2770.                                          S
  2771.  
  2772.              SCSI        
  2773.                Small Computer System Interface. A standard interface protocol for
  2774.                connecting peripherals, usually mass storage devices like hard
  2775.                disks, to computers.
  2776.  
  2777.              selection button       
  2778.                The left mouse button.
  2779.  
  2780.              subdirectory        
  2781.                A directory within another directory
  2782.  
  2783.                                          T
  2784.  
  2785.              Tool Types       
  2786.                A method for passing arguments from the Workbench to a program.
  2787.                BootX uses the tool types to store the user preferences.
  2788.  
  2789.                                          V
  2790.  
  2791.              vector        
  2792.                A memory address used by the operating system to access parts and
  2793.                functions of the libraries and devices. Most viruses change one or
  2794.                more viruses to modify the behaviour of the Amiga.
  2795.  
  2796.              volume        
  2797.                A floppy disk or a hard disk partition
  2798.  
  2799.              volume name       
  2800.                The name given to a disk or partition
  2801.  
  2802.                                          W
  2803.              Workbench        
  2804.                The Amiga's icon-base GUI.
  2805.  
  2806.              write-enable        
  2807.                To allow information to be written onto a disk.
  2808.  
  2809.              write-protect        
  2810.                To prevent information from being written onto a disk.
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.      
  2817.  
  2818.  
  2819.      
  2820.  
  2821.  
  2822.                                  Table Of Contents
  2823.  
  2824.                                     BootX v5.10
  2825.  
  2826.              Chapter 1 Introducing BootX    ....................    4
  2827.                 1.1 System requirements     ....................    4
  2828.                 1.2 About the author and the program ...........    4
  2829.                 1.3 Gettings updates     .......................    5
  2830.                 1.4 Before you complain...    ..................    5
  2831.                 1.5 Acknowledgments      .......................    6
  2832.              Chapter 2 Getting Started    ......................    7
  2833.                 2.1 Installing BootX on hard disk  .............    7
  2834.                 2.2 Starting BootX     .........................    7
  2835.                    2.2.1 Starting BootX from the CLI  ..........    8
  2836.                    2.2.1 Starting BootX from the Workbench  ....    8
  2837.              Chapter 3 The BootX screen   ......................    9
  2838.                 3.1 Quit      ..................................    9
  2839.                 3.2 Read Bootblock     .........................    9
  2840.                 3.3 Write Bootblock     ........................   10
  2841.                 3.4 The drives cycle gadget   ..................   10
  2842.                 3.5 Lock Drive     .............................   10
  2843.                 3.6 Check files     ............................   10
  2844.                 3.7 Show installable bootblocks    .............   10
  2845.                 3.8 Built-in bootblock name    .................   11
  2846.                 3.9 Install      ...............................   11
  2847.                 3.10 Message window     ........................   11
  2848.                 3.11 Main display window    ....................   11
  2849.              Chapter 4 The Project Menu   ......................   12
  2850.                 4.1 Load Recog file    .........................   12
  2851.                 4.2 Show known     .............................   12
  2852.                 4.3 Print known     ............................   13
  2853.                 4.4 Iconify      ...............................   13
  2854.                 4.5 Help      ..................................   14
  2855.                 4.6 About      .................................   14
  2856.                 4.7 Quit      ..................................   14
  2857.              Chapter 5 The Check Menu   ........................   15
  2858.                 5.1 Check blocks     ...........................   15
  2859.                 5.2 Check memory     ...........................   15
  2860.                 5.2 Check vectors     ..........................   16
  2861.                 5.4 Reset vectors     ..........................   16
  2862.                 5.5 Check files     ............................   16
  2863.                    5.5.1 Virus handling     ....................   17
  2864.                    5.5.2 Remove linkviruses     ................   17
  2865.                    5.5.3 Handle viruses automatically    .......   18
  2866.                    5.5.4 Show directories/files/check files    .   18
  2867.                    5.5.5 Check crunched executables    .........   18
  2868.                    5.5.6 Skip read-protected     ...............   19
  2869.                    5.5.7 Auto-remove read-protection     .......   19
  2870.                    5.5.8 Generate report     ...................   20
  2871.                    5.5.9 Silent check     ......................   20
  2872.                    5.5.10 Filter      ..........................   20
  2873.                    5.5.11 Examine directories     ..............   20
  2874.                    5.5.12 Checking files     ...................   20
  2875.                 5.6 Show report     ............................   21
  2876.                 5.7 Save report     ............................   21
  2877.                 5.8 Print report     ...........................   21
  2878.  
  2879.  
  2880.      
  2881.  
  2882.  
  2883.      
  2884.  
  2885.  
  2886.                 5.9 Check disk     .............................   22
  2887.              Chapter 6 The ToolBox Menu   ......................   23
  2888.                 6.1 Filter      ................................   23
  2889.                    6.1.1 New      ..............................   23
  2890.                    6.1.2 Add      ..............................   23
  2891.                    6.1.3 Edit      .............................   23
  2892.                    6.1.4 Remove      ...........................   23
  2893.                    6.1.5 OK      ...............................   24
  2894.              Chapter 7 The Bootblocks Menu   ...................   25
  2895.                 7.1 Load/Save      .............................   25
  2896.                 7.2 Learn      .................................   25
  2897.                 7.3 Show again     .............................   26
  2898.              Chapter 8 The BBLib Menu   ........................   27
  2899.                 8.1 New      ...................................   27
  2900.                 8.2 Load      ..................................   27
  2901.                 8.3 Save      ..................................   28
  2902.                 8.4 Show      ..................................   28
  2903.                 8.5 Merge      .................................   28
  2904.                 8.6 Add bootblock     ..........................   28
  2905.                 8.7 Delete bootblock     .......................   28
  2906.                 8.8 Rename bootblock     .......................   28
  2907.              Chapter 9 The Brain Menu   ........................   30
  2908.                 9.1 New      ...................................   30
  2909.                 9.2 Load      ..................................   30
  2910.                 9.3 Save      ..................................   30
  2911.                 9.4 Show      ..................................   30
  2912.                 9.5 Merge      .................................   31
  2913.                 9.6 Delete Brain cell    .......................   31
  2914.                 8.8 Rename Brain cell    .......................   31
  2915.              Chapter 10 The Preferences Menu   .................   32
  2916.                 10.1 Edit...      ..............................   32
  2917.                    10.1.1 Virus alarm     ......................   32
  2918.                    10.1.2 Save icons     .......................   32
  2919.                    10.1.3 Detect diskchange     ................   32
  2920.                    10.1.4 Check disk-validator     .............   32
  2921.                    10.1.5 Crunch      ..........................   33
  2922.                    10.1.6 Iconify at startup    ................   33
  2923.                    10.1.7 Check memory at startup   ............   34
  2924.                    10.8 Check vectors at startup   .............   34
  2925.                    10.9 Pause after page    ....................   34
  2926.                    10.10 Wrap words     ........................   34
  2927.                    10.11 Display Mode     ......................   34
  2928.                    10.12 Palette      ..........................   35
  2929.                 10.2 Load/Save      ............................   35
  2930.              Chapter 11 Hints tips and tricks  .................   36
  2931.                 11.1 How to kill disk-validator viruses...  ....   36
  2932.                 11.2 Using BootX with little memory  ...........   36
  2933.                 11.3 Copying bootblocks with one drive  ........   37
  2934.              Appendix A Glossary     ...........................   38
  2935.  
  2936.              © 1992 BootX v5.10 written by Peter Stuer
  2937.  
  2938.                           _
  2939.                        _ //
  2940.              Thanks to \X/ Amiga for being the best computer ever !
  2941.  
  2942.  
  2943.  
  2944.      
  2945.  
  2946.